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Appendix 1 - Methods of class HiGraph 



getRoot 

public HiNode getRootO 

returns a HiNode object which forms the root of the node tree 
guaranteed to exist and cannot be deleted or moved 



getConnectionMap 

public headway.util.ICollection getConnectionMapO 

returns a (readonly) map containing all essential connections present in the graph 



addConnection 

public boolean addConnection(HiNode fromNode, 
HiNode toNode) 

Deprecated, create a new connection in the graph from the fromNode to the toNode 



addConnection 

public boolean addConnection(HiConnection he) 

create a new connection in the graph from the fromNode to the toNode 



removeConnection 

public void removeConnection(HiConnection he, 
boolean flush) 

remove the passed HiConnection from the graph. Equivalent to calling remove() on the 
HiConnection 



getNodeMap 

public headway.util.ICollection getNodeMapO 

returns a (readonly) collection containing all the nodes present in the graph irrespective of 
the nodetree structure 

Note that this does not include the root node 
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findNode 

public HiNode findNode(long id) 

utility method to locate a specific node by key (equivalent to calling getElement() on the 
graph's NodeMap) 

Returns the corresponding HiNode object or null if none exists 
? 

findNodeByName 

public HiNode findNodeByName(java.lang. String name) 

utility method which returns the first node found which matches the name passed or null 
if none found. 

Since node names are not guaranteed to be unique, this method should be used with 
extreme care. It is also highly inefficient in that it needs to iterate all nodes in the graph 
doing a string compare on each. 



findFreeNodeName 

public java.lang.String findFreeNodeName(java.lang. String prefix) 

method which finds the first unused node name with the given prefix e.g. passing 

"cluster" might return cluster 1, cluster 2, etc. 



removeNode 

public void removeNode(HiNode hn, 
boolean flush) 



clear 

public void clear() 

clears the graph i.e. removes all nodes and connections 



flush 

public void flush() 

clears the graph i.e. removes all nodes and connections 
Specified by: 

flush in interface headway.util.Flushable 
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getDirty 

public boolean getDirtyQ 



setDirty 

public void setDirty(boolean dirty) 



setDriver 

public void setDriver(HGDriver driver) 



getDriver 

public HGDriver getDriverQ 



Appendix 2 - Fields and Methods of class HiNode 



Fields: 

pathSeparator 

public static java.lang.String pathSeparator 

separation character used for path and fully qualified name 



ID_NEW 

public static final long ID_NEW 



ID_ROOT 

public static final long ID_ROOT 



STATEUNRESOLVED 

public static final int STATE UNRESOLVED 

State indicating that node has not yet been resolved (parsed) 



ST ATERES OL VED 

public static final int STATE RESOLVED 

State indicating that node has been successfully resolved (parsed) 



STATEUNRESOLVABLE 

public static final int STATEJJNRESOLVABLE 

State indicating that node could not be resolved 

Information on the nature of the reolve failure can be obtained by calling 
getResolveFailureld 



STATE_MISSING 

public static final int STATE_MISSING 
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Indicates that node is missing (and therefore unresolvable) 



STATE_WRONG_LOCATION 

public static final int STATE_WRONG_LOCATION 

Indicates that node has no valid driver and is therefore not resolvable 



STATENODRIVER 

public static final int STATE NO DRIVER 

Indicates that node has no valid driver and is therefore not resolvable 



ATTRIBPUBLIC 

public static final int ATTRIB PUBLIC 



ATTRIBPRIVATE 

public static final int ATTRIB PRIVATE 



ATTRIBPROTECTED 

public static final int ATTRIB PROTECTED 



ATTRIBSTATIC 

public static final int ATTRIB STATIC 



ATTRIBFINAL 

public static final int ATTRIB FINAL 



ATTRIB_SYNCHRONIZED 

public static final int ATTRIBSYNCHRONIZED 
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ATTRIBTHREADSAFE 

public static final int ATTRIB THREADSAFE 



ATTRIBTRANSIENT 

public static final int ATTRIB TRANSIENT 



ATTRIB_NATIVE 

public static final int ATTRIB_NATIVE 



ATTRIB_INTERFACE 

public static final int ATTRIBINTERFACE 



ATTRIBABSTRACT 

public static final int ATTRIB AB STRACT 



comparator 

public HiNodeComparator comparator 

Methods: 

resolve 

public int resolve() 

Triggers a parse of the underlying object and loading of connections 



canHaveChildren 

public boolean canHaveChildrenO 

Returns true if this HiNode can contain children 
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isMeta 

public boolean isMetaO 

Returns true if this node is a metanode, i.e. cannot hold direct connections 



isClass 

public boolean isClassQ 



setld 

protected void setId(long id) 
sets the id of this node 



setGraph 

protected void setGraph(HiGraph hg) 
sets the graph in which this node lives 



setType 

public void setType(int type) 

sets the type of the node - the value corresponds to a constant defined in NodeFactory 



setUML 

public void setUML(java.lang.String uml) 
sets a UML respresentation of this node 



getUML 

public java.lang.String getUML() 

returns a UML-style respresentation of this node 



setAttributes 

public void setAttributes(int attributes) 
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takes a bitmask value containing information on various attributes of the node, details see 
ACC constants 



setParent 

protected void setParent(HiNode hn) 
sets the parent of this node 



getType 

public int getTypeO 

returns the type of the node - the value corresponds to a constant defined in NodeFactory 
use getTypeStringQ for a string version 



getTypeString 

public java.lang. String getTypeStringO 

returns a string indicating the type of the node - the value corresponds to a constant 
defined in NodeFactory 



getParent 

public HiNode getParent() 

returns the parent of the node (null if this is the root node) 



setName 

public void setName(java.lang. String sName) 
sets the name of this node 



getName 

public java.lang. String getName() 
returns the name of this node 
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setSourceFile 

public void setSourceFile(java.lang.String sourceFile) 
sets the source file name of this node 



getSourceFile 

public java.lang.String getSourceFileO 
returns the source file name of this node 



setState 

public void setState(int state) 
sets the state of this node 



ijj; getState 

\J public int getState() 

M returns the state of this node 

I 3.1 
jll 
)J| 
| :| 

get Attributes 
j^, public int getAttributesO 

|lj returns a bitmask containing information on various attributes of the node, details see 

jij ACC constants 

0 

£J 

getAttribute 

public boolean getAttribute(int bit) 

returns a boolean indicating whether the passed attribute flag (or flags) are set in the 
attributes mask 



getld 

public long getld() 

returns the unique id of this node 
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getKey 

public java.lang.Object getKeyO 

returns a string key unique to this node (stringified id) 

Specified by: 

getKey in interface headway.util.CollectionMember 



isRoot 

public boolean isRoot() 

returns true if this is the root node (i.e. parent is null) 



getPath 

public java.lang.String getPath() 

returns the path of this node (e.g. java.lang) 

O 

^ 

-I 

4* getFQName 

Ml public java.lang.String getFQNameO 

|:| returns the fully qualified name of this node (e.g. if the name is String and the path is 

jll /java/lang then the fully qualified name is /java/lang/String) 

H 

111 

jlj getGraph 

C| public HiGraph getGraph() 

Ut returns the graph in which this node resides 



getUserObject 

public java.lang.Object getUserObject() 

returns a user-defined object saved with the setUserObject() method 



setUserObject 

public void setUserObject(java.lang.Object obj) 
used to store a reference to an arbitrary object 
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equals 

public boolean equals(HiNode hn) 

true if the passed node is the same as this 



isSibling 

public boolean isSibling(HiNode hn) 

returns true if the passed HiNode is a sibling of this node, i.e. shares the same parent 



toString 

public java.lang. String toStringQ 

returns the fully qualified name of the node 

Overrides: 



getChildren 

public headway .util.ICollection getChildren() 

returns a JCollection of the children of this node 

throws an IllegalSomething exception if this node is a leaf 



getChildren 

public headway .util.ICollection getChildren(HiNodeComparator comparator) 

returns a JCollection of the children of this node 

throws an IllegalSomething exception if this node is a leaf 



toString in class java.lang. Object 




addChild 

public HiNode addChild(HiNode hn) 

creates and returns a new child node of the requested type 

Parameters: 

int - type as defined in NodeFactory 

long - known id of an existing object or ID_NEW (-1) for a new object 
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moveTo 

public void moveTo(HiNode hn, 
boolean flush) 



getConnections 

public headway.util.ICollection getConnections(int direction) 
returns a collection of connections for this node 
Parameters: 

int - the requested direction HiEdge.TO or HiEdge.FROM 

int - mode MODECONNECTIONDIRECT or MODE CONNECTION ANY 



getRelationship 

public Relationship getRelationship(HiNode hn, 
int direction) 

returns a Relationship object describing the relationship between this node and the passed 
node for the given direction, a null relationship is signified by the isEmpty flag in the 
relationship object. A null pointer is returned if the passed node is itself null or if it is 
equal to "this" node 



getChildRelationships 

public headway.util.ICollection getChildRelationships() 

convenience wrapper function which returns all the relationships between the child nodes 
of this node (which must be capable of having children) 



getConnectionCount 

public int getConnectionCount(int direction) 

returns the total number of (potentially rolled up) connections which apply to this node in 
the given direction 



countConnections 
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protected int countConnections(int runningTotal, 
int direction, 
HiNode ancestor) 

counts all connections with recursive calls if an ancestor node is supplied, connections 
where the referenced node is a descendant of the ancestor are ignored 



flush 

public void flush() 

clears the graph i.e. removes all nodes and connections 
Specified by: 

flush in interface headway.util.Flushable 



findCommonAncestor 

public HiNode findCommonAncestor(HiNode hn) 

Utility treewalking method which takes a HiNode argument and returns the (nearest) 
common ancestor, guaranteed to return a node (possibly root) provided that neither of this 
node nor the argument node passed is itself the root, in which case an 
IllegalArgumentException is thrown 

Examples: this = root.java.util.Vector 
hn = root.java.lang.String 
ret =root.java 
this = root.a.b.c.d 
hn = root.a.b.e.f.g.h.i 
ret = root.a.b 



findFirstDescendant 

public HiNode findFirstDescendant(HiNode hn) 

Utility treewalking method which takes a HiNode argument which is assumed to be a 
descendant of this node and find the first descendant of this node which is also an 
ancestor of the passed node 

returns null if the node passed is not a descendant of this node 

Examples: this = root.java 

hn = root.java.lang.String 
ret = root.java.lang 
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this = root.a.b 

hn = root.a.b.e.f.g.h.i 

ret =root.a.b.e 



isDescendantOf 

public boolean isDescendantOf(HiNode hn) 



setFQEntityName 

public void setFQEntityName(java.lang.String fqentityname) 



f*i getFQEntityName 

jjtj public java.lang.String getFQEntityName() 



f»SI 

ill 



getEntityName 

public java.lang.String getEntityName() 



ill 

jlj getEntityPath 

CI public java.lang.String getEntityPath() 

O 
D 
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Appendix 3 - Methods of the MetaNode class 
resolve 

public int resolveO 

Description copied from class: HiNode 

Triggers a parse of the underlying object and loading of connections 
Overrides: 

resolve in class HiNode 



resolve 

public int resolve(boolean recursive) 



canHaveChildren 

^ public boolean canHaveChildren() 

^ Description copied from class: HiNode 

\j Returns true if this is can contain children 

4* Overrides: 

111 canHaveChildren in class HiNode 

iif 
jj| 

n 

y h isMeta 

jl| public boolean isMeta() 

jlj Description copied from class: HiNode 

£| Returns true if this node is a metanode, i.e. cannot hold direct connections 

Q Overrides: 

M isMeta in class HiNode 



getState 

public int getStateO 

Description copied from class: HiNode 

returns the state of this node 

Overrides: 

getState in class HiNode 
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Appendix 4- Methods of the ClassNode class 



canHaveChildren 

public boolean canHaveChildrenO 

Description copied from class: HiNode 

Returns true if this is can contain children 

Overrides: 

canHaveChildren in class HiNode 



isMeta 

public boolean isMetaO - 

Description copied from class: HiNode 

Returns true if this node is a metanode, i.e. cannot hold direct connections 
Overrides: 

isMeta in class HiNode 



getFQSourceFile 

public java.lang.String getFQSourceFileQ 



resolve 

public final int resolve() 

Description copied from class: HiNode 

Triggers a parse of the underlying object and loading of connections 
Overrides: 

resolve in class HiNode 




isClass 

public boolean isClass() 
Overrides: 

isClass in class HiNode 



m 



isApplicationClass 

public boolean isApplicationClassQ 
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Appendix 5 - Methods of the FieldNode Class 

canHaveChildren 

public boolean canHaveChildren() 

Description copied from class: HiNode 

Returns true if this is can contain children 

Overrides: 

canHaveChildren in class HiNode 



isMeta 

public boolean isMeta() 

Description copied from class: HiNode 

Returns true if this node is a metanode, i.e. cannot hold direct connections 
Overrides: 

isMeta in class HiNode 

o 

$ 

41 getState 

|J| public int getState() 

j :| Description copied from class: HiNode 

jtJ returns the state of this node 

( " s Overrides: 

(=i getState in class HiNode 

iii 
ni 

ft 

O 
ti 
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Appendix 6 - Methods of the MethodNode Class 

canHaveChildren 

public boolean canHaveChildren() 

Description copied from class: HiNode 

Returns true if this is can contain children 

Overrides: 

canHaveChildren in class HiNode 



isMeta 

public boolean isMeta() 

Description copied from class: HiNode 

Returns true if this node is a metanode, i.e. cannot hold direct connections 
Overrides: 

isMeta in class HiNode 



getState 

public int getState() 

Description copied from class: HiNode 

returns the state of this node 

Overrides: 

getState in class HiNode 
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Appendix 7 - Data Fields, Constructors, and Methods of HiEdge class 
Fields: 

DEPENDENCY 

public static final int DEPENDENCY 



AGGREGATION 

public static final int AGGREGATION 



IMPLEMENTS 

public static final int IMPLEMENTS 



EXTENDS 

public static final int EXTENDS 



FROM 

public static final int FROM 



TO 

public static final int TO 

Constructors: 

HiEdge 

public HiEdge(HiNode fromNode, 
HiNode toNode) 



HiEdge 

public HiEdge(HiNode hnl, 
HiNode hn2, 
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# 

int direction) 
Methods: 

makeKey 

public static java.lang.Long makeKey(HiNode fromNode, 

HiNode toNode) 



makeKey 

public static java.lang.Long makeKey(HiNode hnl, 

HiNode hn2, 
int direction) 



getNode 

public HiNode getNode(int direction) 

returns the referenced node for the given direction 



getToggledNode 

public HiNode getToggledNode(int direction) 
returns the referenced node for the given direction 



getKey 

public java.lang.Object getKey() 
returns a unique key for this object 

implementation is a Long DWord-style long containing the fromNode id in the low word 
and the toNode id in the high word 

Specified by: 

getKey in interface headway.util.CollectionMember 



getGraph 

public HiGraph getGraph() 

returns the graph in which the edge resides 
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toString 

public java.lang.String toStringO 
Overrides: 

toString in class javaJang.Object 



getType 

public int getTypeQ 



Q 

Ml 



111 
Up 

hi 

hi 



setType 

public void setType(int type) 



isDependency 

public boolean isDependencyQ 



isAggregation 

public boolean isAggregation() 



,P islmplements 

public boolean islmplements() 



isExtends 

public boolean isExtendsQ 



getVerboseName 

public java.lang.String getVerboseName() 

returns a longwinded string version of the edge in the form A-->B, used mainly for debug 
purposes 
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toggleDirection 

public static int toggleDirection(int direction) 



getNodeld 

public long getNodeId(int direction) 



Ml 
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Appendix 8 - Methods of Relationship Class 
Methods: 

isMeta 

public boolean isMetaQ 



getCarriedConnections 

public int getCarriedConnectionsO 



isEmpty 

public boolean isEmptyQ 
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